ITsSbResourcePluginStoreEx::AcquireTargetLock メソッド

  • [アーティクル]

ターゲットをロックします。

構文

HRESULT AcquireTargetLock(
  [in]  BSTR     targetName,
  [in]  DWORD    dwTimeout,
  [out] IUnknown **ppContext
);

パラメーター

targetName [in]

ロックするターゲットの名前。

dwTimeout [in]

操作のタイムアウト (ミリ秒単位)。

ppContext [out]

ロックのコンテキストへのポインターを返します。 ロックを解除するには、このポインターを ReleaseTargetLock メソッドに指定します。

戻り値

このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

解説

ロックが取得されると、呼び出し元のスレッドはターゲット オブジェクトへの排他的アクセス権を持つものと見なされるため、(同じマシン内の) 他のスレッドで更新することはできません。 したがって、呼び出し元のスレッドは、ターゲット オブジェクトに必要な更新を行った直後に ReleaseTargetLock メソッドを呼び出す必要があります。

重要

このロックにより、デプロイに複数の接続ブローカーが存在する場合に、ターゲット オブジェクトが外部で変更されるのを完全に防ぐわけではありません。 エラーを適切に処理し、ターゲットの更新を再試行するには、呼び出し元のスレッドを準備する必要があります。

このメソッドは、ITsSbResourcePluginStoreEx インターフェイスに KB3091411 がインストールされているWindows Server 2012 R2 で使用できます。

要件

要件 値
サポートされている最小のクライアント
 サポートなし
サポートされている最小のサーバー
 Windows Server 2012 R2
サーバー サポートの終了
 Windows Server 2012 R2
IDL
SbTsV.idl
IID
 IID_ITsSbResourcePluginStoreExは 80b83ffd-625d-11e5-bea1-a0481c7e9064 として定義されています

関連項目

ITsSbResourcePluginStoreEx