IInternetBindInfoEx::GetBindInfoEx Method

Gets the BINDINFO structure associated with the binding operation.

Syntax

HRESULT GetBindInfoEx(      
    DWORD *grfBINDF,
    BINDINFO *pbindinfo,
    DWORD *grfBINDF2,
    DWORD *pdwReserved
);

Parameters

• grfBINDF
  [out]  A bitwise combination of BINDF enumeration values that indicates how the bind process is handled.
• pbindinfo
  [in, out]  A BINDINFO structure that describes the binding requirements of the client application.
• grfBINDF2
  [out]  A BINDF2 enumeration value that specifies additional information for the bind.
• pdwReserved
  [out] Reserved. Must be set to NULL.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method exists because the grfBINDF parameter in IInternetBindInfo::GetBindInfo can contain no additional flags. This method inherits all behaviors of IInternetBindInfo::GetBindInfo and adds some of its own. Therefore, the Remarks section of IInternetBindInfo::GetBindInfo applies to this method in full.

Relative to the IInternetBindInfo::GetBindInfo method, the IInternetBindInfoEx::GetBindInfoEx method provides the additional parameters grfBINDF2 and pdwReserved. The data in grfBINDF2 is an extension of the data in the grfBINDF parameter.

Example

HRESULT GetBindInfoTest::GetBindInfo
    (DWORD *grfBINDINFOF, BINDINFO *pbindinfo)
{
    DWORD dwBINDINFOF2;
    DWORD dwReserved;
    
    return GetBindInfoEx
        (grfBINDINFOF, pbindinfo, &dwBINDINFOF2, &dwReserved);
}
                

See Also

Asynchronous Pluggable Protocol Overviews and Tutorials, IInternetBindInfo::GetBindInfo