MprAdminInterfaceGetCredentialsEx

Use the MprAdminInterfaceGetCredentialsEx function to retrieve extended credentials information for the specified interface. Use this function to retrieve credentials information used for Extensible Authentication Protocols (EAPs).

DWORD MprAdminInterfaceGetCredentialsEx(
  MPR_SERVER_HANDLE hMprServer,  // handle to router
  HANDLE hInterface,             // handle to interface
  DWORD dwLevel,                 // format of credentials
  LPBYTE *lplpbBuffer            // retrieved credentials
);

Parameters

hMprServer
[in] Handle to a Windows 2000 router. This handle is obtained from a previous call to MprAdminServerConnect.
hInterface
[in] Handle to the interface. This handle is obtained from a previous call to MprAdminInterfaceCreate.
dwLevel
[in] Specifies the format of credentials information retrieved. This parameter must be zero, which indicates that the information is formatted as an MPR_CREDENTIALSEX_0 structure.
lplpbBuffer
[in] Pointer to a pointer to an MPR_CREDENTIALSEX_0 structure to receive the extended credentials information. Free the memory occupied by this structure with MprAdminBufferFree.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The calling application does not have sufficient privileges.
ERROR_INVALID_HANDLE The hInterface value is invalid.
ERROR_INVALID_PARAMETER The lplpbBuffer parameter is NULL.
ERROR_NOT_ENOUGH_MEMORY Insufficient resources to complete the operation.
ERROR_NOT_SUPPORTED The dwLevel value is invalid.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Mprapi.h.
  Library: Use Mprapi.lib.

See Also

MprAdminInterfaceCreate, MprAdminInterfaceGetCredentials, MprAdminInterfaceSetCredentialsEx, MprAdminServerConnect