Microsoft DirectX 8.1 (C++)

IServices::get_ItemWithProviderName

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_ItemWithProviderName method retrieves a Service object from the collection by the name of the provider.

Syntax

HRESULT get_ItemWithProviderName(
  BSTR  bstrProviderName,
  IService**  ppVal
);

Parameters

bstrProviderName

[in]  Specifies the provider name.

ppVal

[out]  Address of a variable to receive the IService interface pointer of the retrieved object.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_INVALIDARG A matching object was not found.
E_POINTER Data cannot be read from or written to a supplied address.

See Also