MprAdminIsServiceInitialized 関数 (mprapi.h)

MprAdminIsServiceInitialized 関数は、呼び出し元のプロセスがアクセス権を持っている場合に、指定したサーバーで RRAS サービスが実行されているかどうかを確認します。

構文

DWORD MprAdminIsServiceInitialized(
  [in] LPWSTR lpwsServerName,
  [in] BOOL   *fIsServiceInitialized
);

[in] lpwsServerName

クエリを実行するサーバーの名前を指定する null で終わる Unicode 文字列へのポインター。このパラメーターが NULL の場合、関数はローカルコンピューターに対してクエリを実行します。

[in] fIsServiceInitialized

出力時に、 RRAS サービスが lpwsServerName 内のサーバーで実行されているかどうかを指定する BOOL へのポインター。

値	説明
TRUE	サービスは、指定されたサーバーで実行されています。
FALSE	指定したサーバーでサービスが実行されていないか、呼び出し元のプロセスが RRAS サービスにアクセスできません。

関数が成功した場合、戻り値は NO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	説明
ERROR_INVALID_PARAMETER	fIsServiceInitialized パラメーターは NULL です。
ERROR_SERVICE_NOT_ACTIVE	RRAS サービスがサーバー上で実行されていません。
ERROR_ACCESS_DENIED	呼び出し元のアプリケーションに十分な特権がありません。


サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mprapi.h
Library	Mprapi.lib
[DLL]	Mprapi.dll