NDdeGetShareSecurity, fonction

[DDE réseau n’est plus pris en charge. Nddeapi.dll est présent sur Windows Vista, mais tous les appels de fonction retournent NDDE_NOT_IMPLEMENTED.]

Récupère le descripteur de sécurité associé au partage DDE. Cette opération est généralement effectuée à des fins de modification.

Syntaxe

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

Paramètres

lpszServer [in]

Nom du serveur sur lequel réside le DSDM.

lpszShareName [in]

Nom du partage dont le descripteur de sécurité doit être récupéré à partir du DSDM. Ce paramètre ne peut pas être NULL.

si [in]

Valeur SECURITY_INFORMATION qui spécifie les informations de sécurité à récupérer à partir du descripteur de sécurité associé au partage.

pSD [out]

Pointeur vers une structure SECURITY_DESCRIPTOR qui reçoit le descripteur de sécurité auto-relatif. Ce paramètre peut être NULL. Si ce paramètre a la valeur NULL, le DSDM détermine la taille des informations de sécurité demandées et retourne le nombre d’octets nécessaires dans le paramètre lpcbsdRequired , ainsi que le code d’erreur NDDE_BUF_TOO_SMALL.

cbSD [in]

Taille de la mémoire tampon pSD . Ce paramètre doit être égal à zéro si pSD a la valeur NULL.

lpcbsdRequired [out]

Pointeur vers la variable qui reçoit la taille réelle du descripteur de sécurité récupéré. Ce paramètre ne peut pas être NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est NDDE_NO_ERROR.

Si la fonction échoue, la valeur de retour est un code d’erreur, qui peut être traduit en message d’erreur texte en appelant NDdeGetErrorString. Si le paramètre pSD était NULL, il retourne NDDE_BUF_TOO_SMALL.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Nddeapi.h
Bibliothèque	Nddeapi.lib
DLL	Nddeapi.dll
Noms Unicode et ANSI	NDdeGetShareSecurityW (Unicode) et NDdeGetShareSecurityA (ANSI)

Voir aussi

Vue d’ensemble de l’échange dynamique de données réseau

Fonctions DDE réseau

SECURITY_INFORMATION

NDdeSetShareSecurity