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

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

値 意味
WNPS_FILE
 1 つのファイル。
WNPS_DIR
 1 つのディレクトリ。
WNPS_MULT
 複数のファイル、ディレクトリ、またはその両方の選択。

[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 も呼び出して拡張エラー情報を設定する必要があります。 拡張エラー コードには、次のようなものがあります。

リターン コード 説明
WN_OUT_OF_MEMORY
 リソースから文字列を読み込めませんでした。
WN_MORE_DATA
 指定されたバッファーが小さすぎて、ボタンのテキストに合わせられません。
WN_BAD_VALUE
 lpName パラメーターは予期しない形式です。
WN_NOT_SUPPORTED
 プロパティ ダイアログ ボックスは、指定されたオブジェクトの種類 nType ではサポートされていません。

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h