Funzione NDdeGetShareSecurity

[Network DDE non è più supportato. Nddeapi.dll è presente in Windows Vista, ma tutte le chiamate di funzione restituiscono NDDE_NOT_IMPLEMENTED.]

Recupera il descrittore di sicurezza associato alla condivisione DDE. Questa operazione viene eseguita in genere per la modifica.

Sintassi

UINT NDdeGetShareSecurity(
  _In_  LPTSTR               lpszServer,
  _In_  LPTSTR               lpszShareName,
  _In_  SECURITY_INFORMATION si,
  _Out_ PSECURITY_DESCRIPTOR pSD,
  _In_  DWORD                cbSD,
  _Out_ LPDWORD              lpcbsdRequired
);

Parametri

lpszServer [in]

Nome del server in cui risiede il DSDM.

lpszShareName [in]

Nome della condivisione il cui descrittore di sicurezza deve essere recuperato dal DSDM. Questo parametro non può essere NULL.

si [in]

Valore SECURITY_INFORMATION che specifica le informazioni di sicurezza da recuperare dal descrittore di sicurezza associato alla condivisione.

pSD [out]

Puntatore a una struttura SECURITY_DESCRIPTOR che riceve il descrittore di sicurezza self-relative. Questo parametro può essere NULL. Se questo parametro è NULL, DSDM determina le dimensioni delle informazioni di sicurezza richieste e restituisce il numero di byte necessari nel parametro lpcbsdRequired insieme al codice di errore NDDE_BUF_TOO_SMALL.

cbSD [in]

Dimensioni del buffer pSD . Questo parametro deve essere zero se pSD è NULL.

lpcbsdRequired [out]

Puntatore alla variabile che riceve le dimensioni effettive del descrittore di sicurezza recuperato. Questo parametro non può essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NDDE_NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore, che può essere convertito in un messaggio di errore di testo chiamando NDdeGetErrorString. Se il parametro pSD era NULL, restituisce NDDE_BUF_TOO_SMALL.

Requisiti

Vedi anche

Panoramica di Network Dynamic Data Exchange

Funzioni DDE di rete

SECURITY_INFORMATION

NDdeSetShareSecurity