MprAdminInterfaceGetCredentialsEx 関数 (mprapi.h)
MprAdminInterfaceGetCredentialsEx 関数を使用して、指定したインターフェイスの拡張資格情報を取得します。 この関数を使用して、拡張認証プロトコル (EAP) に使用される資格情報を取得します。
構文
DWORD MprAdminInterfaceGetCredentialsEx(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[out] LPBYTE *lplpbBuffer
);
パラメーター
[in] hMprServer
ルーターへのハンドル。 このハンドルは、 MprAdminServerConnect の以前の呼び出しから取得されます。
[in] hInterface
インターフェイスへのハンドル。 このハンドルは、 MprAdminInterfaceCreate の以前の呼び出しから取得されます。
[in] dwLevel
lplpbBuffer パラメーターで情報が返される形式を表す DWORD 値。 dwLevel に使用できる値は、次の表に示すように 0 または 1 です。
| 値 | 構造体の形式 |
|---|---|
| 0 | Windows 2000 Server: MPR_CREDENTIALSEX_0 |
| 1 | Windows Server 2003 以降: MPR_CREDENTIALSEX_1 |
値 1 は、情報がインターフェイスの事前共有キーであり、暗号化された形式であることを示します。
[out] lplpbBuffer
正常に完了すると、 MPR_CREDENTIALSEX_0 または MPR_CREDENTIALSEX_1 構造体へのポインター。 dwLevel パラメーターは、構造体の種類を示します。 MprAdminBufferFree を使用して、この構造体によって占有されているメモリを解放します。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 意味 |
|---|---|
|
呼び出し元のアプリケーションに十分な特権がありません。 |
|
hInterface 値が無効です。 |
|
lplpbBuffer パラメーターは NULL です。 |
|
操作を完了するためのリソースが不足しています。 |
|
dwLevel 値が無効です。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |
こちらもご覧ください
MprAdminInterfaceGetCredentials