I_NetLogonControl2関数 (lmaccess.h)
I_NetLogonControl2関数は、Netlogon サービスのさまざまな側面を制御します。
構文
NET_API_STATUS NET_API_FUNCTION I_NetLogonControl2(
[in, optional] LPCWSTR ServerName,
[in] DWORD FunctionCode,
[in] DWORD QueryLevel,
[in] LPBYTE Data,
[out] LPBYTE *Buffer
);
パラメーター
[in, optional] ServerName
リモート サーバーの名前。
[in] FunctionCode
実行する操作。 この値には、次のいずれかを指定できます。
[in] QueryLevel
Netlogon サービスから返される情報を示します。 この値には、次のいずれかの構造体を指定できます。
NETLOGON_INFO_1 (1)
NETLOGON_INFO_2 (2)
NETLOGON_INFO_3 (3)
NETLOGON_INFO_4 (4)
[in] Data
FunctionCode パラメーターで指定された値に依存する入力データを格納します。 NETLOGON_CONTROL_REDISCOVERおよびNETLOGON_CONTROL_TC_QUERY関数コードは、信頼されたドメイン名を指定します (データ型は LPWSTR *)。
[out] Buffer
QueryLevel パラメーターで渡される構造体で要求された情報を含むバッファーへのポインターを返します。
バッファーは NetApiBufferFree を使用して解放する必要があります。
戻り値
メソッドは、成功した0x00000000 (NERR_Success) を返します。それ以外の場合は、Lmerr.h または Winerror.h で定義されている 0 以外のエラー コードが返されます。 エラー コードNET_API_STATUS、値0x00000834で始まります。 ネットワーク管理エラー コードの詳細については、「 Network_Management_Error_Codes」を参照してください。 返される可能性がある戻り値を次の表に示します。
| リターン コード/値 | Description |
|---|---|
|
メソッド呼び出しはエラーなしで完了しました。 |
|
呼び出し元に対するアクセス検証は false を返します。 アクセスが拒否されました。 |
|
このコマンドを処理するのに十分なストレージがありません。 |
|
関数コードは、指定されたサーバーでは無効です。 たとえば、NETLOGON_CONTROL_REPLICATEがプライマリ ドメイン コントローラー (PDC) に渡されている可能性があります。 |
|
パラメーターが正しくありません。 |
|
クエリ呼び出しレベルが正しくありません。 |
|
サービスは開始されていません。 |
|
指定されたコンピューター名の形式が無効です。 |
|
現在、ログオン要求を処理できるログオン サーバーはありません。 |
|
ドメイン間信頼アカウントのパスワード変更がバックアップ ドメイン コントローラー (BDC) で試行されました。 この操作は、ドメインの PDC に対してのみ許可されます。 |
|
指定したドメインが存在しないか、またはアクセスできません。 |
|
ユーザー名が見つかりませんでした。 |
解説
この関数を使用して、BDC が SAM データベースのコピーを最新の状態に保つよう要求できます。 また、BDC が現在 PDC に対してセキュリティで保護されたチャネルを開いているかどうかを判断するためにも使用できます。
必要条件
| 対象プラットフォーム | Windows |
| ヘッダー | lmaccess.h |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示