Skip to main content
ATL Server Library Reference 
IAuthInfo::GetPassword 

This method is called when an HTTP authorization implementation requires a password to access a protected URL.


HRESULT GetPassword( 
   LPTSTR szPwd, 
   DWORD *pdwBuffSize 
);

Parameters

szPwd

A pointer to a buffer where the IAuthInfo implementation is to store the required password.

pdwBuffSize

The address of a DWORD that, on entry, contains the size of the buffer provided as szPwd. Implementations of IAuthInfo should not exceed the buffer size when providing domain information. On exit, pdwBuffSize should contain the size of the password including the NULL terminator.

An HRESULT indicating the success or failure of the call. Returns 0 if the password is successfully retrieved, otherwise nonzero.

The GetPassword method is typically called by a CAtlBaseAuthObject derived class that is attempting to satisfy the security requirements of a requested URL.