Edit

Share via

PcNewServiceGroup function (portcls.h)

  • Article

The PcNewServiceGroup function creates and initializes a service group.

Syntax

PORTCLASSAPI NTSTATUS PcNewServiceGroup(
  [out]          PSERVICEGROUP *OutServiceGroup,
  [in, optional] PUNKNOWN      OuterUnknown
);

Parameters

[out] OutServiceGroup

Pointer to the service-group object created by this function. This parameter points to the caller-allocated pointer variable into which the function outputs the pointer to the IServiceGroup object. Specify a valid, non-NULL pointer value for this parameter.

[in, optional] OuterUnknown

Pointer to the IUnknown interface of an object that needs to aggregate the object. Unless aggregation is required, set this parameter to NULL.

Return value

PcNewServiceGroup returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.

Remarks

The OutServiceGroup and OuterUnknown parameters follow the reference-counting conventions for COM objects.

Requirements

Requirement Value
Minimum supported client The PortCls system driver implements the PcNewServiceGroup function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems.
Target Platform Universal
Header portcls.h (include Portcls.h)
Library Portcls.lib
IRQL PASSIVE_LEVEL

See also

IServiceGroup