CertSrvIsServerOnlineW 関数 (certbcli.h)

CertSrvIsServerOnline 関数は、Certificate Services サーバーがオンラインかどうかを判断します。Certificate Services サーバーがオンラインでない場合、バックアップ操作は成功しません。

構文

HRESULT CERTBCLI_API CertSrvIsServerOnlineW(
  [in]  WCHAR const *pwszServerName,
  [out] BOOL        *pfServerOnline
);

パラメーター

[in] pwszServerName

オンライン状態をチェックするサーバーの NetBIOS または DNS マシン名へのポインター。

[out] pfServerOnline

Certificate Services サーバーがオンラインの場合は TRUE 、オンラインでない場合は FALSE になるブール値へのポインター。

戻り値

戻り値は HRESULT です。 証明書サービスが実行されていない場合、この関数は失敗します。 Certificate Services が実行されていて、要求を受け入れる準備ができている場合、この関数は S_OKを返し、*pfServerOnline は TRUE の値を指します。 Certificate Services が中断 (または一時停止) モードで実行されている場合、この関数はS_OKを返し、*pfServerOnline は FALSE の値を指 します。

注釈

この関数を呼び出して、Certificate Services サーバーがオンラインでバックアップ操作に使用できるかどうかを判断します。

Certadm.dll のこの関数の名前は CertSrvIsServerOnlineW です。 GetProcAddress を呼び出すときは、この形式の名前を使用する必要があります。 また、この関数は Certbcli.h ヘッダー ファイルで FNCERTSRVISSERVERONLINEW 型として定義されます。

例

FNCERTSRVISSERVERONLINEW* pfnOnline = NULL;
char * szOnlineFunc = "CertSrvIsServerOnlineW";
BOOL       bOnline = 0;
HRESULT    hr = 0;

// Get the address of the function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnOnline = (FNCERTSRVISSERVERONLINEW*) GetProcAddress(hInst,
                                        szOnlineFunc );
if ( NULL == pfnOnline )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szOnlineFunc,
           GetLastError() );
    exit(1);  // Or other appropriate error action.
}

// Call the function; wszServer was set earlier to the server name.
hr = pfnOnline(wszServer, &bOnline);
if (FAILED(hr))
{
    printf("Failed pfnOnline, hr=%x, err=%d\n",
           hr,
           GetLastError());
    exit(1);  // Or other appropriate error action.
}

// Display the online status.
printf("Server is %s\n", 
       (bOnline ? "Online" : "Suspended" ));

要件

こちらもご覧ください

CertSrvBackupPrepare

証明書サービスのバックアップと復元の機能の使用