MprAdminIsDomainRasServer 関数 (mprapi.h)

MprAdminIsDomainRasServer 関数は、指定されたマシンがドメイン内のリモート アクセス サーバーとして登録されているかどうかに関する情報を返します。

構文

DWORD MprAdminIsDomainRasServer(
  [in]  LPWSTR pszDomain,
  [in]  LPWSTR pszMachine,
  [out] PBOOL  pbIsRasServer
);

パラメーター

[in] pszDomain

リモート アクセス サーバーに対してクエリを実行するドメイン。

[in] pszMachine

リモート アクセス サーバーの名前。

[out] pbIsRasServer

コンピューターがドメインに登録されている場合は TRUE を返し、それ以外の場合は FALSE を返します。

戻り値

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

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

値	意味
ERROR_DS_SERVER_DOWN	pszDomain が無効です。
ERROR_NOT_FOUND	pszMachine が無効です。
ERROR_DS_OPERATIONS_ERROR	ユーザーはドメイン以外のユーザーです。
ERROR_NO_SUCH_DOMAIN	どのドメインにも参加していないマシンで実行される関数。

注釈

この関数は、ドメインに参加しているマシンでのみ実行する必要があります。

例

次のコード例は、 MprAdminIsDomainRasServer 関数と MprAdminEstablishDomainRasServer 関数の使用方法を示しています。

#include <windows.h>
#include <stdio.h>
#include "mprapi.h"
#pragma comment(lib, "mprapi.lib")

int __cdecl main(){
    
    // The domain and RAS machine names being queried. These MUST be changed before using this sample code.
    PWCHAR pszDomain = L"YourDomainName.com";
    PWCHAR pszMachine = L"YourRASMachine";
    
    BOOL bIsRegistered = FALSE;
    DWORD dwRes = ERROR_SUCCESS;
    MPR_SERVER_HANDLE phMprServer;

    // Make sure RRAS is running on the remote server
    dwRes = MprAdminServerConnect(pszMachine, &phMprServer);
    if(dwRes != ERROR_SUCCESS){
        wprintf (L"RRAS is not running on %s.\n", pszMachine);
        return dwRes;
    }
     
    // Close RRAS handle. It's not needed.
    MprAdminServerDisconnect(&phMprServer);
 
    // Check to see if pszMachine is a RAS server for the domain
    dwRes = MprAdminIsDomainRasServer (pszDomain, pszMachine, &bIsRegistered);
    if (dwRes != ERROR_SUCCESS){
        //
        // Handle errors here
        //
       return dwRes;
    }

    if (bIsRegistered == TRUE){
        wprintf (L"The RRAS Server on %s is already registered in domain %s.\n", pszMachine, pszDomain);
        return ERROR_SUCCESS;
    }

    wprintf (L"The RRAS Server on %s is NOT registered in domain %s. Registering now...\n", pszMachine, pszDomain);
    dwRes = MprAdminEstablishDomainRasServer (pszDomain, pszMachine, TRUE);
    if (dwRes != ERROR_SUCCESS){
        //
        // Handle errors here
        //
        return dwRes;
    }
    return ERROR_SUCCESS;
}

要件

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

こちらもご覧ください

ルーター管理機能

ルーター管理リファレンス