NPGetPropertyText 関数 (npapi.h)

ネットワーク リソースのプロパティ ダイアログ ボックスに追加するボタンの名前を取得します。

構文

DWORD NPGetPropertyText(
  [in]      DWORD  iButton,
  [in]      DWORD  nPropSel,
  [in]      LPWSTR lpName,
  [out]     LPWSTR lpButtonName,
  [in, out] DWORD  nButtonNameLen,
  [in]      DWORD  nType
);

パラメーター

[in] iButton

ボタンのインデックスを示します。 ファイル マネージャーでは、最大 6 つのボタンがサポートされています。 このパラメーターには、1 つのファイルのみが選択されている場合は使用可能なボタンごとに 1 から 6、複数のファイルが選択されている場合は 11 から 16 の番号が付きます。

[in] nPropSel

プロパティ ダイアログ ボックスがフォーカスする項目を指定します。 これには、次のいずれかの値を指定できます。

[in] lpName

ダイアログ ボックスを使用して表示または編集するアイテムの名前を含む null で終わる文字列へのポインター。 サポートされている項目はファイルとディレクトリのみであるため、項目名はファイル名です。 これらは明確で、ワイルドカード文字を含めず、完全修飾にする必要があります (たとえば、C:\LOCAL\EXAMPLE.DOC)。 複数のファイル名はスペースで区切る必要があります。 スペースを含むファイル名は、引用符 ("C:\My File" など) で囲む場合があります。 この場合は 。 これは単一の名前として扱われます。 キャレット文字 '^' は、1 文字の引用符メカニズムとしても使用できます (たとえば、C:\My^"File、"C:\My^"File" はどちらもファイル C:\My"File を参照します)。

[out] lpButtonName

ネットワーク プロバイダーがプロパティ ボタンの名前をコピーするバッファーへのポインター。 成功した場合、 lpButtonName が指すバッファーには、プロパティ ボタンの名前が含まれます。 終了時にこのバッファーに空の文字列が含まれている場合、その名前に対応するボタンと、成功するすべてのボタンがダイアログ ボックスから削除されます。 ネットワーク プロバイダーは、ボタンを "スキップ" できません。

[in, out] nButtonNameLen

lpButtonName バッファーのサイズ (終端の null 文字を含む) を文字単位で指定します。

[in] nType

WNTYPE_FILEする必要がある項目の種類を指定します。

戻り値

関数が成功した場合は、WN_SUCCESSを返す必要があり、 lpButtonName を使用できます。 空の文字列を指している場合、 iButton ほど高いインデックスに対応するボタンはありません。 戻り値がWN_SUCCESS以外の場合、プロバイダーは SetLastError も呼び出して拡張エラー情報を設定する必要があります。 拡張エラー コードには、次のようなものがあります。

注釈

ファイル マネージャーは、プロパティ ダイアログ ボックスが表示されるたびにこの関数を呼び出し、ダイアログ ボックスを表示する前にこれを行います。 ユーザーがネットワーク プロバイダーによってこの関数によって追加されたボタンをクリックすると、 NPPropertyDialog 関数が適切なパラメーターで呼び出されます。

ファイル マネージャーのみが NPGetPropertyText を呼び出し、この関数をファイルとディレクトリに使用します。

要件