MprAdminIsDomainRasServer-Funktion (mprapi.h)

Artikel
03/04/2024

Die Funktion MprAdminIsDomainRasServer gibt Informationen darüber zurück, ob der angegebene Computer als RAS-Server in der Domäne registriert ist.

Syntax

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

Parameter

[in] pszDomain

Die Domäne, in der Sie den RAS-Server abfragen möchten.

[in] pszMachine

Der Name des RAS-Servers.

[out] pbIsRasServer

Gibt TRUE zurück, wenn der Computer in der Domäne registriert ist, andernfalls wird FALSE zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_DS_SERVER_DOWN	pszDomain ist ungültig.
ERROR_NOT_FOUND	pszMachine ist ungültig.
ERROR_DS_OPERATIONS_ERROR	Der Benutzer ist ein Nicht-Domänenbenutzer.
ERROR_NO_SUCH_DOMAIN	Die Funktion wird auf einem Computer ausgeführt, der keiner Domäne beigetreten ist.

Hinweise

Diese Funktion darf nur auf einem Computer ausgeführt werden, der in eine Domäne eingebunden ist.

Beispiele

Der folgende Beispielcode zeigt die Verwendung der Funktionen MprAdminIsDomainRasServer und 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;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll

Weitere Informationen

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung

Freigeben über