Functia NetGetDCName (lmaccess.h) – aplicatii Win32

• 12/05/2018
• 3 minute de citit

In acest articol

Functia NetGetDCName returneaza numele controlerului de domeniu principal (PDC). Nu returneaza numele controlerului de domeniu de rezerva (BDC) pentru domeniul specificat. De asemenea, nu puteti distanta aceasta functie pe un server non-PDC.

Aplicatiile care accepta nume in stil DNS ar trebui sa apeleze functia DsGetDcName. Controlerele de domeniu din acest tip de mediu au o relatie de replicare multi-master. Prin urmare, poate fi avantajos pentru aplicatia dvs. sa utilizati un DC care nu este PDC. Puteti apela functia DsGetDcName pentru a localiza orice DC din domeniu; NetGetDCName returneaza doar numele PDC.

Sintaxa

NET_API_STATUS NET_API_FUNCTION NetGetDCName (LPCWSTR ServerName, LPCWSTR DomainName, LPBYTE * Buffer);

Parametrii

Numele serverului

Un indicator catre un sir constant care specifica numele DNS sau NetBIOS al serverului la distanta pe care urmeaza sa fie executata functia. Daca acest parametru este NULL , este utilizat computerul local.

Numele domeniului

Un indicator catre un sir constant care specifica numele domeniului. Numele de domeniu trebuie sa fie un nume de domeniu NetBIOS (de exemplu, Microsoft). NetGetDCName nu accepta nume in stil DNS (de exemplu, microsoft.com). Daca acest parametru este NULL , functia returneaza numele controlerului de domeniu pentru domeniul primar.

Tampon

Valoare returnata

Daca functia reuseste, valoarea returnata este NERR_Success.

Daca functia esueaza, valoarea returnata poate fi unul dintre urmatoarele coduri de eroare.

Cod de returnare Descriere

NERR_DCNotFound

Nu s-a putut gasi controlerul de domeniu pentru domeniul specificat in parametrul nume de domeniu .

ERROR_BAD_NETPATH

Calea retelei nu a fost gasita. Aceasta eroare este returnata daca computerul specificat in parametrul servername nu a putut fi gasit.

ERROR_INVALID_NAME

Sintaxa numelui este incorecta. Aceasta eroare este returnata daca numele specificat in parametrul servername contine caractere ilegale.

ERROR_NOT_SUPPORTED

Solicitarea nu este acceptata.

Observatii

Nu este necesara calitatea de membru special al grupului pentru a executa cu succes functia NetGetDCName .

Exemple

Urmatorul exemplu de cod demonstreaza cum se poate prelua controlerul de domeniu principal utilizand functia

NetGetDCName . Esantionul apeleaza NetGetDCName specificand parametrii servername si domainname. Daca apelul reuseste, codul imprima informatii despre numele controlerului de domeniu principal. In cele din urma, esantionul elibereaza memoria alocata pentru bufferul unde a fost returnat numele controlerului de domeniu.

#ifndef UNICODE #define UNICODE #endif #include <stdio.h> #include <stdlib.h> // pentru functia _wtoi #include <assert.h> #include <windows.h> #include <lm.h> // Trebuie sa va conectati cu netapi32.lib #pragma comment (lib, “netapi32.lib”) int wmain (int argc, wchar_t * argv []) {NET_API_STATUS nStatus; LPCWSTR lpServer = NULL; LPCWSTR lpDomain = NULL; LPCWSTR lpDcName = NULL; if (argc! = 3) {wprintf (L “Utilizare:% ws <ServerName> <DomainName> \ n”, argv [0]); wprintf (L “% ws Domeniul Myserver \ n”, argv [0]); iesire (1); } lpServer = argv [1]; lpDomain = argv [2]; wprintf (L “Apelarea NetGetDCName cu parametri \ n”); wprintf (L “lpServer =% ws \ n”, lpServer); wprintf (L “lpDomain =% ws \ n”, lpDomain); // // Apelati functia NetGetDCName // nStatus = NetGetDCName (lpServer, lpDomain, (LPBYTE *) & lpDcName); // // Daca apelul reuseste, // if (nStatus == NERR_Success) {wprintf (L “NetGetDCName a reusit \ n”, nStatus); wprintf (L “DC Name =% ws \ n”, lpDcName); // Trebuie sa eliberati bufferul returnat nStatus = NetApiBufferFree ((LPVOID) lpDcName); if (nStatus! = NERR_Success) wprintf (L “NetApiBufferFree a esuat cu eroare:% lu (0x% lx) \ n”, nStatus, nStatus); } else {wprintf (L “NetGetDCName a esuat cu eroare:% lu (0x% lx) \ n”, nStatus, nStatus); wprintf (L “Eroare =”); switch (nStatus) {case ERROR_INVALID_PARAMETER: wprintf (L “ERROR_INVALID_PARAMETER \ n”); pauza; caz ERROR_NO_SUCH_DOMAIN: wprintf (L “ERROR_NO_SUCH_DOMAIN \ n”); pauza; caz ERROR_NOT_SUPPORTED: wprintf (L “ERROR_NOT_SUPPORTED \ n”); pauza; caz ERROR_BAD_NETPATH: wprintf (L ” wprintf (L “ERROR_INVALID_COMPUTERNAME \ n”); pauza; caz DNS_ERROR_INVALID_NAME_CHAR: wprintf (L “DNS_ERROR_INVALID_NAME_CHAR \ n”); pauza; caz DNS_ERROR_NON_RFC_NAME: wprintf (L “DNS_ERROR_NON_RFC_NAME \ n”); pauza; caz ERROR_INVALID_NAME: wprintf (L “ERROR_INVALID_NAME \ n”); pauza; caz NERR_DCNotFound: wprintf (L “NERR_DCNotFound \ n”); pauza; caz NERR_WkstaNotStarted: wprintf (L “NERR_WkstaNotStarted \ n”); pauza; caz RPC_S_SERVER_UNAVAILABLE: wprintf (L “RPC_S_SERVER_UNAVAILABLE \ n”); pauza; caz RPC_E_REMOTE_DISABLED: wprintf (L “RPC_E_REMOTE_DISABLED \ n”); pauza; implicit: wprintf (L “Alta eroare, consultati Winerror.h sau lmerr.h) \ n”); pauza; }} return nStatus; } wprintf (L “ERROR_INVALID_COMPUTERNAME \ n”); pauza; caz DNS_ERROR_INVALID_NAME_CHAR: wprintf (L “DNS_ERROR_INVALID_NAME_CHAR \ n”); pauza; caz DNS_ERROR_NON_RFC_NAME: wprintf (L “DNS_ERROR_NON_RFC_NAME \ n”); pauza; caz ERROR_INVALID_NAME: wprintf (L “ERROR_INVALID_NAME \ n”); pauza; caz NERR_DCNotFound: wprintf (L “NERR_DCNotFound \ n”); pauza; caz NERR_WkstaNotStarted: wprintf (L “NERR_WkstaNotStarted \ n”); pauza; caz RPC_S_SERVER_UNAVAILABLE: wprintf (L “RPC_S_SERVER_UNAVAILABLE \ n”); pauza; caz RPC_E_REMOTE_DISABLED: wprintf (L “RPC_E_REMOTE_DISABLED \ n”); pauza; implicit: wprintf (L “Alta eroare, vezi Winerror.h sau lmerr.h) \ n”); pauza; }} return nStatus; }

Cerinte

    Client minim acceptat Windows 2000 Professional [numai aplicatii desktop] Server minim acceptat Windows 2000 Server [numai aplicatii desktop] Platforma tinta Antet Windows lmaccess.h (include Lm.h) Biblioteca Netapi32.lib DLL Netapi32.dll

Vezi si

DsGetDcName

Obtineti functii

NetGetAnyDCName

Functii de gestionare a retelei

Prezentare generala a gestionarii retelei