次の方法で共有

SetClusterServiceAccountPassword 関数 (clusapi.h)

  • [アーティクル]

[この関数は、[要件] セクションで指定したオペレーティング システムで使用できます。 この関数のサポートは Windows Server 2008 で削除されました。この関数は何も実行せず 、ERROR_CALL_NOT_IMPLEMENTEDを返します。]

使用可能なすべてのクラスター ノードのクラスター サービス ユーザー アカウントのパスワードを変更します。 PCLUSAPI_SET_CLUSTER_SERVICE_ACCOUNT_PASSWORD型は、この関数へのポインターを定義します。

構文

DWORD SetClusterServiceAccountPassword(
  [in]           LPCWSTR                      lpszClusterName,
  [in]           LPCWSTR                      lpszNewPassword,
  [in, optional] DWORD                        dwFlags,
  [out]          PCLUSTER_SET_PASSWORD_STATUS lpReturnStatusBuffer,
  [in, out]      LPDWORD                      lpcbReturnStatusBufferSize
);

パラメーター

[in] lpszClusterName

クラスターの名前を指定する NULL で終わる Unicode 文字列。

[in] lpszNewPassword

クラスター サービス ユーザー アカウントの新しいパスワードを指定する NULL で終わる Unicode 文字列。

[in, optional] dwFlags

パスワード更新をクラスターに適用する方法を説明するフラグを含む 、CLUSTER_SET_PASSWORD_FLAGS 列挙から列挙された値のビットフィールド (省略可能)。

既定では (dwFlags = 0)、すべてのクラスター ノードが使用可能でない限り、関数は続行されません。

CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES (1 (0x1))

すべてのノードが使用できない場合でも 、SetClusterServiceAccountPassword 関数を続行します。 この関数は、可能な限り多くのノードでパスワードの変更を試みますが、 ClusterNodeUp または ClusterNodePaused 状態に含まれていないすべてのノード ( GetClusterNodeState を参照) は更新されません。

[out] lpReturnStatusBuffer

各クラスター ノードのパスワード更新の結果を記述する CLUSTER_SET_PASSWORD_STATUS 構造体の配列を受け取る出力バッファーへのポインター。 このパラメーターが NULL ではなく、バッファーが結果のデータを保持するのに十分な大きさでない場合、関数は ERROR_MORE_DATA を返し、 lpcbReturnStatusBufferSize を出力バッファーに必要なサイズに設定します。 このパラメーターが NULL の場合、パスワードの更新は実行されません。関数は lpcbReturnStatusBufferSize を必要なバッファー サイズに設定し、 ERROR_SUCCESSを返します。

[in, out] lpcbReturnStatusBufferSize

入力時に、出力バッファーのサイズ (バイト単位) を指定する値へのポインター。 出力時に、結果のデータの実際のサイズ (バイト単位) を指定する値へのポインター。 lpReturnStatusBuffer が NULL の場合でも、出力サイズは常に指定されます。 このパラメーターを NULL にすることはできません。

戻り値

操作が成功すると、関数は ERROR_SUCCESS (0) を返します。

操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。

リターン コード/値 Description
ERROR_ALL_NODES_NOT_AVAILABLE
5037 (0x13AD)
 クラスター内の一部のノードが使用できず (つまり、 ClusterNodeStateUp または ClusterNodeStatePaused 状態ではありません)、 CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES フラグが設定されていません。
ERROR_MORE_DATA
234 (0xEA)
 lpReturnStatusBuffer が指す出力バッファーが、結果のデータを保持するのに十分な大きさではなかった。

解説

既定では、 SetClusterServiceAccountPassword 関数は、クラスター内のすべてのノード (つまり、 ClusterNodeStateUp または ClusterNodeStatePaused 状態) が使用可能でない限り、何も実行しません。 CLUSTER_SET_PASSWORD_IGNORE_DOWN_NODES フラグを使用してこの動作をオーバーライドできますが、パスワードの更新に失敗したノードは、そのノードでパスワードが手動で更新されるまでクラスターに参加できないことに注意してください。

新しいパスワードがノードの古いパスワードと同じ場合、パスワードの更新はそのノードに適用されず 、ERROR_SUCCESS が返されます。

この関数は、クラスター サービス ユーザー アカウントのドメイン コントローラーによって格納されているパスワードを更新しません。

リソース DLL から SetClusterServiceAccountPassword を呼び出さないでください。

要件

   
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 Datacenter、Windows Server 2003 Enterprise
対象プラットフォーム Windows
ヘッダー clusapi.h
Library ClusAPI.lib
[DLL] ClusAPI.dll

関連項目

CLUSTER_SET_PASSWORD_FLAGS

CLUSTER_SET_PASSWORD_STATUS

クラスター管理機能