IAFS_BindContext::OnGetUserAccount Method

Revision as of 00:28, 26 May 2015

Retrieves user account requisites. Displays request dialog to user or returns previously stored data if silent mode is requested.

Syntax

HRESULT OnGetUserAccount([in]                      IAFS_Name*  pName,
                         [in]                      LPWSTR      pTitle,
                         [in]                      LPWSTR      pText,
                         [out]                     BSTR*       ppUserName,
                         [out]                     BSTR*       ppPassword,
                         [in, defaultvalue(NULL)]  IUnknown*   pIcon,
                         [in, defaultvalue(0)]     LONG        nFlags);

Parameters

pName

[in] Filename, access to which should be granted using returned user account requisites. Pass null to get the requisites for the general access to the file system.

pTitle

[in] The title of the request dialog.

pText

[in] The text of request that should be shown in the dialog.

ppUserName

[out] Pointer to a buffer that receives a pointer to the account user name string.

ppPassword

[out] Pointer to a buffer that receives a pointer to the account password string.

pIcon

[in, optional] Icon to show in the dialog. Should provide IUIX_Icon or IUIX_ImageData interface.

nFlags

[in, defaultvalue(0)] Pass AFS_BindContext_NoUI flag for silent mode or 0 for dialog request.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IAFS_BindContext

IAFS_BindContext