Compartir a través de

Función MprAdminIsDomainRasServer (mprapi.h)

  • Artículo

La función MprAdminIsDomainRasServer devuelve información sobre si la máquina especificada está registrada como servidor de acceso remoto en el dominio.

Sintaxis

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

Parámetros

[in] pszDomain

Dominio en el que desea consultar el servidor de acceso remoto.

[in] pszMachine

Nombre del servidor de acceso remoto.

[out] pbIsRasServer

Devuelve TRUE si la máquina está registrada en el dominio; de lo contrario, devuelve FALSE.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_DS_SERVER_DOWN
 pszDomain no es válido.
ERROR_NOT_FOUND
 pszMachine no es válido.
ERROR_DS_OPERATIONS_ERROR
 El usuario es un usuario que no es de dominio.
ERROR_NO_SUCH_DOMAIN
 Función ejecutada en un equipo no unido a ningún dominio.

Comentarios

Esta función solo se debe ejecutar en un equipo unido a un dominio.

Ejemplos

En el código de ejemplo siguiente se muestra el uso de las funciones MprAdminIsDomainRasServer y 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;
}

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

Funciones de administración del enrutador

Referencia de administración de enrutadores