IUri::GetUserInfo method

项目
07/13/2016

Returns the user name and password, as parsed from the Uniform Resource Identifier (URI).

Syntax

HRESULT GetUserInfo(
  [out] BSTR *pbstrUserInfo
);

Parameters

pbstrUserInfo [out]
Address of a BSTR that receives the property value. Caller is responsible for freeing the memory with SysFreeString.

Return value

Returns one of the following values:

Return code	Description
S_OK	Success.
S_FALSE	The property is not defined.
E_OUTOFMEMORY	There is insufficient memory to create the BSTR.

Remarks

IUri::GetUserInfo was introduced in Windows Internet Explorer 7.

Security Warning: Storing sensitive information as clear text in a URI is not recommended. According to RFC3986: Uniform Resource Identifier (URI), Generic Syntax, Section 7.5, "A password appearing within the userinfo component is deprecated and should be considered an error except in those rare cases where the 'password' parameter is intended to be public."

This function is for convenience. It is the same as calling IUri::GetPropertyBSTR with the Uri_PROPERTY_USER_INFO property.

Requirements

Minimum supported client	Windows XP with SP2
Minimum supported server	Windows Server 2003 with SP1
Product	Internet Explorer 7
Header	Urlmon.h
IDL	Urlmon.idl
DLL	Urlmon.dll

通过