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
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
