NDdeGetTrustedShare-Funktion
[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist auf Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE _ NICHT _ IMPLEMENTIERT zurück.]
Ruft die Optionen ab, die einer DDE-Freigabe zugeordnet sind, die sich in der Liste der vertrauenswürdigen Freigaben des Serverbenutzers befindet.
Syntax
UINT NDdeGetTrustedShare(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_Out_ LPDWORD lpdwTrustOptions,
_Out_ LPDWORD lpdwShareModId0,
_Out_ LPDWORD lpdwShareModId1
);
Parameter
-
lpszServer [ In]
-
Der Name des Servers, auf dem sich das DSDM befindet.
-
lpszShareName [ In]
-
Der Freigabename, dessen vertrauenswürdiger Status abgefragt wird. Dieser Parameter darf nicht NULL sein.
-
lpdwTrustOptions [ out]
-
Ein Zeiger auf eine Variable, die die Vertrauensoptionen empfängt. Dieser Parameter darf nicht NULL sein. Die folgenden Vertrauensstellungsoptionen sind verfügbar.
Wert Bedeutung - NDDE _ CMD _ SHOW _ MASK
- 0x0000FFFFL
Maske, die zum Abrufen des Werts verwendet wird, der zum Überschreiben des DDE-Freigabe-Showzustands verwendet wird, wenn NDDE _ TRUST _ CMD _ SHOW festgelegt ist. - NDDE _ TRUST _ CMD _ SHOW
- 0x10000000L
Überschreiben Sie den in der DDE-Freigabe-DSDM angegebenen Show-Zustand. - NDDE _ TRUST _ SHARE _ DEL
- 0x20000000L
Entfernen Sie den vertrauenswürdigen Status der Freigabe. - NDDE _ TRUST _ SHARE _ INIT
- 0x40000000L
Ermöglichen Sie es einem Client, die Anwendung zu initiieren, wenn sie bereits im Kontext des Benutzers ausgeführt wird. - NDDE _ TRUST _ SHARE _ START
- 0x80000000L
Lassen Sie zu, dass die Anwendung im Kontext des Benutzers gestartet wird. -
lpdwShareModId0 [ out]
-
Ein Zeiger auf eine Variable, die den ersten Teil des vertrauenswürdigen Freigabe-Änderungsbezeichners empfängt. Dieser Parameter darf nicht NULL sein.
-
lpdwShareModId1 [ out]
-
Ein Zeiger auf eine Variable, die den zweiten Teil des vertrauenswürdigen Freigabe-Änderungsbezeichners empfängt. Dieser Parameter darf nicht NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert NDDE _ NO _ ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, der durch Aufrufen von NDdeGetErrorStringin eine Textfehlermeldung übersetzt werden kann.
Hinweise
Der Änderungsbezeichner der vertrauenswürdigen Freigabe spiegelt die Version der DDE-Freigabe im DSDM zum Zeitpunkt der ersten Vertrauenswürdigung der DDE-Freigabe wider. Der Änderungsbezeichner der vertrauenswürdigen Freigabe wird hauptsächlich verwendet, um veraltete vertrauenswürdige Freigaben zu entfernen. Der Benutzer muss jedoch keine veralteten vertrauenswürdigen Freigaben entfernen. Der Netzwerk-DDE-Agent entfernt veraltete Freigaben im Namen des Benutzers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
NDdeGetTrustedShareW (Unicode) und NDdeGetTrustedShareA (ANSI) |