IMFNetCredentialCache::GetCredential method (mfidl.h)

Retrieves the credential object for the specified URL.

Syntax

HRESULT GetCredential(
  [in]  LPCWSTR          pszUrl,
  [in]  LPCWSTR          pszRealm,
  [in]  DWORD            dwAuthenticationFlags,
  [out] IMFNetCredential **ppCred,
  [out] DWORD            *pdwRequirementsFlags
);

Parameters

[in] pszUrl

A null-terminated wide-character string containing the URL for which the credential is needed.

[in] pszRealm

A null-terminated wide-character string containing the realm for the authentication.

[in] dwAuthenticationFlags

Bitwise OR of zero or more flags from the MFNetAuthenticationFlags enumeration.

[out] ppCred

Receives a pointer to the IMFNetCredential interface. The caller must release the interface.

[out] pdwRequirementsFlags

Receives a bitwise OR of zero or more flags from the MFNetCredentialRequirements enumeration.

Return value

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.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFNetCredentialCache