Edit

Share via

IMFNetCredential::GetPassword method (mfidl.h)

  • Article

Retrieves the password.

Syntax

HRESULT GetPassword(
  [out]     BYTE  *pbData,
  [in, out] DWORD *pcbData,
  [in]      BOOL  fEncryptData
);

Parameters

[out] pbData

Pointer to a buffer that receives the password. To find the required buffer size, set this parameter to NULL. If fEncryptData is FALSE, the buffer contains a wide-character string. Otherwise, the buffer contains encrypted data.

[in, out] pcbData

On input, specifies the size of the pbData buffer, in bytes. On output, receives the required buffer size. If fEncryptData is FALSE, the size includes the terminating null character.

[in] fEncryptData

If TRUE, the method returns an encrypted string. Otherwise, the method returns an unencrypted string.

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.

Remarks

If the password is not available, the method might succeed and set *pcbData to zero.

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

IMFNetCredential