IWSDDeviceProxy::GetServiceProxyByType method (wsdclient.h)

Retrieves a generic IWSDServiceProxy proxy for a service exposed by the device by port type name.

Syntax

HRESULT GetServiceProxyByType(
  [in]  const WSDXML_NAME *pType,
  [out] IWSDServiceProxy  **ppServiceProxy
);

Parameters

[in] pType

Reference to a WSDXML_NAME structure that specifies the port type name.

[out] ppServiceProxy

Pointer to the IWSDServiceProxy object associated with the specified service.

Return value

Possible return values include, but are not limited to, the following:

Return code	Description
S_OK	Method completed successfully.
E_POINTER	pType or ppServiceProxy is NULL.
E_INVALIDARG	There is no metadata associated with the service specified by pType.
E_OUTOFMEMORY	Insufficient memory to complete the operation.
E_FAIL	There is no endpoint associated with the service proxy.

Remarks

If the device hosts more than one service of the specified type, a proxy for any one of the services may be returned. In such a case, callers should not depend on any particular service proxy being returned.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wsdclient.h (include Wsdapi.h)
DLL	Wsdapi.dll

See also

IWSDDeviceProxy