Fungsi MprAdminIsDomainRasServer (mprapi.h)

Artikel
02/29/2024

Fungsi MprAdminIsDomainRasServer mengembalikan informasi mengenai apakah komputer yang diberikan terdaftar sebagai server akses jarak jauh di domain.

Sintaks

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

Parameter

[in] pszDomain

Domain tempat Anda ingin mengkueri server akses jarak jauh.

[in] pszMachine

Nama server akses jarak jauh.

[out] pbIsRasServer

Mengembalikan TRUE jika komputer terdaftar di domain, jika tidak, komputer mengembalikan FALSE.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_DS_SERVER_DOWN	pszDomain tidak valid.
ERROR_NOT_FOUND	pszMachine tidak valid.
ERROR_DS_OPERATIONS_ERROR	Pengguna adalah pengguna non-domain.
ERROR_NO_SUCH_DOMAIN	Fungsi yang dijalankan pada komputer yang tidak bergabung ke domain apa pun.

Keterangan

Fungsi ini harus dijalankan hanya pada komputer yang bergabung ke domain.

Contoh

Contoh kode berikut menunjukkan penggunaan fungsi MprAdminIsDomainRasServer dan 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;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	mprapi.h
Pustaka	Mprapi.lib
DLL	Mprapi.dll

Lihat juga

Fungsi Administrasi Perute

Referensi Manajemen Router

Bagikan melalui