Sets the port parameter for the given port to a value given by the caller. This allows the service implementer to define port-specific data.

BOOLEAN SetPortParameter(
    RTHANDLE hPort,
    LPVOID pParameter
);

Parameters

hPort

A handle for a port.

pParameter

A user-defined parameter which can be later returned using GetPortParameter.

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_CONTEXT 0x0005

The port is being deleted or the service is being uninstalled.

E_EXIST 0x0006

The hPort parameter is not a valid handle.

E_TYPE 0x8002

The hPort parameter is not a handle for a port or a service.

Requirements

See Also

RT Service system calls, GetPortParameter