GetBindInfoEx method

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](ms774966(v=vs.85).md)

    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);
}

See also

Reference

IInternetBindInfo::GetBindInfo

Conceptual

About Asynchronous Pluggable Protocols