NDdeGetTrustedShare 関数
[ネットワーク DDE はサポートされなくなりました。 Nddeapi.dllは Windows Vista に存在しますが、すべての関数呼び出しはNDDE_NOT_IMPLEMENTEDを返します。
サーバー ユーザーの信頼された共有の一覧にある DDE 共有に関連付けられているオプションを取得します。
構文
UINT NDdeGetTrustedShare(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_Out_ LPDWORD lpdwTrustOptions,
_Out_ LPDWORD lpdwShareModId0,
_Out_ LPDWORD lpdwShareModId1
);
パラメーター
-
lpszServer [in]
-
DSDM が存在するサーバーの名前。
-
lpszShareName [in]
-
信頼された状態のクエリを実行している共有名。 このパラメーターを NULL にすることはできません。
-
lpdwTrustOptions [out]
-
信頼オプションを受け取る変数へのポインター。 このパラメーターを NULL にすることはできません。 次の信頼オプションを使用できます。
値 説明 - NDDE_CMD_SHOW_MASK
- 0x0000FFFFL
DDE 共有の表示状態をオーバーライドするために使用される値を取得するために使用されるマスク (NDDE_TRUST_CMD_SHOWが設定されている場合)。 - NDDE_TRUST_CMD_SHOW
- 0x10000000L
DDE 共有 DSDM で指定された show 状態をオーバーライドします。 - NDDE_TRUST_SHARE_DEL
- 0x20000000L
共有の信頼済み状態を削除します。 - NDDE_TRUST_SHARE_INIT
- 0x40000000L
ユーザーのコンテキストで既に実行されている場合は、クライアントがアプリケーションに対して開始できるようにします。 - NDDE_TRUST_SHARE_START
- 0x80000000L
ユーザーのコンテキストでアプリケーションを起動できるようにします。 -
lpdwShareModId0 [out]
-
信頼された共有変更識別子の最初の部分を受け取る変数へのポインター。 このパラメーターを NULL にすることはできません。
-
lpdwShareModId1 [out]
-
信頼された共有の変更識別子の 2 番目の部分を受け取る変数へのポインター。 このパラメーターを NULL にすることはできません。
戻り値
関数が成功した場合、戻り値はNDDE_NO_ERROR。
関数が失敗した場合、戻り値はエラー コードであり、 NDdeGetErrorString を呼び出すことでテキスト エラー メッセージに変換できます。
解説
信頼された共有変更識別子は、DDE 共有が最初に信頼済み状態を付与された時点の DSDM 内の DDE 共有のバージョンを反映します。 信頼された共有の変更識別子は、主に古い信頼された共有を削除するために使用されます。 ただし、ユーザーは古い信頼された共有を削除する必要はありません。 ネットワーク DDE エージェントは、ユーザーの代わりに古い共有を削除します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|
Unicode 名と ANSI 名 |
NDdeGetTrustedShareW (Unicode) と NDdeGetTrustedShareA (ANSI) |