MprAdminIsDomainRasServer, fonction (mprapi.h)

Article
03/06/2024

La fonction MprAdminIsDomainRasServer retourne des informations indiquant si l’ordinateur donné est inscrit en tant que serveur d’accès à distance dans le domaine.

Syntaxe

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

Paramètres

[in] pszDomain

Domaine dans lequel vous souhaitez interroger le serveur d’accès à distance.

[in] pszMachine

Nom du serveur d’accès à distance.

[out] pbIsRasServer

Retourne TRUE si l’ordinateur est inscrit dans le domaine ; sinon, il retourne FALSE.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_DS_SERVER_DOWN	pszDomain n’est pas valide.
ERROR_NOT_FOUND	pszMachine n’est pas valide.
ERROR_DS_OPERATIONS_ERROR	L’utilisateur n’est pas un utilisateur de domaine.
ERROR_NO_SUCH_DOMAIN	Fonction exécutée sur un ordinateur qui n’est joint à aucun domaine.

Remarques

Cette fonction doit être exécutée uniquement sur un ordinateur joint à un domaine.

Exemples

L’exemple de code suivant montre l’utilisation des fonctions MprAdminIsDomainRasServer et 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;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll

Voir aussi

Fonctions d’administration du routeur

Informations de référence sur la gestion des routeurs

Partager via