NDdeGetTrustedShare-Funktion

[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist unter Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE_NOT_IMPLEMENTED 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 der DSDM befindet.

lpszShareName [in]

Der Freigabename, dessen vertrauenswürdige status abgefragt wird. Dieser Parameter darf nicht NULL sein.

lpdwTrustOptions [out]

Ein Zeiger auf eine Variable, die die Vertrauensstellungsoptionen empfängt. Dieser Parameter darf nicht NULL sein. Die folgenden Vertrauensoptionen sind verfügbar.

Wert	Bedeutung
NDDE_CMD_SHOW_MASK 0x0000FFFFL	Maske, die verwendet wird, um den Wert abzurufen, der zum Überschreiben des DDE-Freigabezustands verwendet wird, wenn NDDE_TRUST_CMD_SHOW festgelegt ist.
NDDE_TRUST_CMD_SHOW 0x10000000L	Überschreiben Sie den im DSDM der DDE-Freigabe angegebenen Showstatus.
NDDE_TRUST_SHARE_DEL 0x200000000L	Entfernen Sie die vertrauenswürdige status der Freigabe.
NDDE_TRUST_SHARE_INIT 0x400000000L	Erlauben Sie einem Client, die Anwendung zu initiieren, wenn sie bereits im Kontext des Benutzers ausgeführt wird.
NDDE_TRUST_SHARE_START 0x800000000L	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, wird der Rückgabewert NDDE_NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, der durch Aufrufen von NDdeGetErrorString in eine Textfehlermeldung übersetzt werden kann.

Bemerkungen

Der vertrauenswürdige Freigabe-Änderungsbezeichner gibt die Version der DDE-Freigabe im DSDM an, als der DDE-Freigabe anfänglich vertrauenswürdige status gewährt wurde. Der Bezeichner zum Ändern der vertrauenswürdigen Freigabe wird in erster Linie 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	Nddeapi.h
Bibliothek	Nddeapi.lib
DLL	Nddeapi.dll
Unicode- und ANSI-Name	NDdeGetTrustedShareW (Unicode) und NDdeGetTrustedShareA (ANSI)

Weitere Informationen

Übersicht über den dynamischen Netzwerkdatenaustausch

Netzwerk-DDE-Funktionen

NDdeSetTrustedShare