IWSDDeviceProxy::GetServiceProxyByType method (wsdclient.h)

  • Article

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