GetBindInfoEx method

Article
07/13/2016

Gets the BINDINFO structure associated with the binding operation.

Syntax

HRESULT retVal = object.GetBindInfoEx(grfBINDF, pbindinfo, grfBINDF2, pdwReserved);

Parameters

grfBINDF [out]
Type: DWORD

A bitwise combination of BINDF enumeration values that indicates how the bind process is handled.
pbindinfo [in, out]
Type: BINDINFO

A BINDINFO structure that describes the binding requirements of the client application.
grfBINDF2 [out]
Type: DWORD

A BINDF2 enumeration value that specifies additional information for the bind.
pdwReserved [out]
Type: DWORD

Reserved. Must be set to NULL.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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.

Examples

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