QueryServiceLockStatusW

指定したサービス制御マネージャデータベースのロック状態を取得する。(Unicode)

QueryServiceLockStatusW hSCManager, lpLockStatus, cbBufSize, pcbBytesNeeded

hSCManager : [intptr] サービス制御マネージャデータベースへのハンドル。OpenSCManager 関数がこのハンドルを返し、SC_MANAGER_QUERY_LOCK_STATUS アクセス権を持っている必要がある。詳細はサービスのセキュリティとアクセス権を参照のこと。
lpLockStatus : [var] 指定したデータベースのロック状態を受け取る QUERY_SERVICE_LOCK_STATUS 構造体へのポインタ。メンバが指す文字列も併せて返される。
cbBufSize : [int] lpLockStatus パラメータが指すバッファのサイズ（バイト単位）。
pcbBytesNeeded : [var] 関数が失敗した場合に、すべてのロック状態情報を返すために必要なバイト数を受け取る変数へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

指定したサービス制御マネージャデータベースのロック状態を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError
を呼び出す。以下のエラーコードがサービス制御マネージャによって設定される場合がある。そのほかのエラーコードは、サービス制御マネージャが呼び出すレジストリ関数によって設定される場合がある。
（以下省略）

[備考]
QueryServiceLockStatus 関数は、指定したデータベースがロックされているかどうかを示す
QUERY_SERVICE_LOCK_STATUS
構造体を返す。データベースがロックされている場合、この構造体はロックを所有するユーザのアカウント名とロックが保持されている時間の長さを提供する。プロセスは
LockServiceDatabase
関数を呼び出してサービス制御マネージャデータベースのロックの所有権を取得し、UnlockServiceDatabase
関数を呼び出してロックを解放する。
> [!NOTE] > winsvc.h ヘッダは QueryServiceLockStatus
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報