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 |
|
Bibliothèque |
|
DLL |
|
Noms Unicode et ANSI |
NDdeGetShareSecurityW (Unicode) et NDdeGetShareSecurityA (ANSI) |