MprAdminInterfaceSetCredentials 関数 (mprapi.h)
MprAdminInterfaceSetCredentials 関数を使用して、指定されたデマンド ダイヤル インターフェイスでのダイヤルアウトに使用するドメイン、ユーザー名、パスワードを設定します。
構文
DWORD MprAdminInterfaceSetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[in] LPWSTR lpwsUserName,
[in] LPWSTR lpwsDomainName,
[in] LPWSTR lpwsPassword
);
パラメーター
[in] lpwsServer
この呼び出しを実行するルーターの名前を指定する null で終わる Unicode 文字列へのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションでこのパラメーターに NULL が 指定されている場合、呼び出しはローカル コンピューターで実行されます。
[in] lpwsInterfaceName
デマンド ダイヤル インターフェイスの名前を指定する null で終わる Unicode 文字列へのポインター。 MprAdminInterfaceGetInfo を使用してインターフェイス名を取得します。
[in] lpwsUserName
ユーザー名を指定する null で終わる Unicode 文字列へのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションでこのパラメーターに NULL が 指定されている場合、この関数は、このインターフェイスに関連付けられているユーザー名を変更しません。
[in] lpwsDomainName
ドメイン名を指定する null で終わる Unicode 文字列へのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションでこのパラメーターに NULL が 指定されている場合、この関数は、このインターフェイスに関連付けられているドメイン名を変更しません。
[in] lpwsPassword
パスワードを指定する null で終わる Unicode 文字列へのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションでこのパラメーターに NULL が 指定されている場合、関数はこのインターフェイスに関連付けられているパスワードを変更しません。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
以下のうち少なくとも 1 つが true です。
|
|
資格情報を格納するための新しいデータ構造を作成するにはメモリが不足しています。 |
|
FormatMessage を使用して、返されるエラー コードに対応するシステム エラー メッセージを取得します。 |
解説
lpwsUserName、lpwsPassword、lpwsDomainName の各パラメーターは省略可能です。 呼び出し元のアプリケーションで 3 つのパラメーターすべてに NULL が 指定されている場合、 MprAdminInterfaceSetCredentials は、このインターフェイスのすべての資格情報を削除します。
定数 UNLEN、PWLEN、DNLEN は、ユーザー名、パスワード、およびドメイン名の最大長です。 これらの定数は Lmcons.h で定義されます。
MprAdminInterfaceSetCredentials のパラメーターの順序は、MprAdminInterfaceGetCredentials とは異なります。
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |