NPFormatNetworkName 関数 (npapi.h)

コントロールに表示するために、ネットワーク名をプロバイダー固有の形式でフォーマットします。

構文

DWORD NPFormatNetworkName(
  [in]      LPWSTR  lpRemoteName,
  [out]     LPWSTR  lpFormattedName,
  [in, out] LPDWORD lpnLength,
  [in]      DWORD   dwFlags,
  [in]      DWORD   dwAveCharPerLine
);

パラメーター

[in] lpRemoteName

形式を設定するネットワーク名へのポインター。

[out] lpFormattedName

書式設定された名前を受け取る文字列へのポインター。

[in, out] lpnLength

lpFormattedName バッファーのサイズを文字で指定する DWORD へのポインター。 この関数の戻り値がWN_MORE_DATA場合、 lpnLength には必要なバッファー サイズが文字で格納されます。

[in] dwFlags

要求される形式の種類を示すビットフィールド。 このパラメーターには、次のいずれかの値を指定できます。

さらに、前のフラグの修飾子として機能する次のフラグは、ビットごとの OR 演算を使用して含めることができます。

[in] dwAveCharPerLine

ネットワーク名が表示される 1 行に収まる平均文字数を指定します。 具体的には、この値は、コントロールの表示に使用されるフォントから TEXTMETRIC 構造体の tmAveCharWidth フィールドで除算されたコントロールの幅として定義されます。

戻り値

関数が成功すると、WN_SUCCESSが返されます。

関数が失敗した場合は、次の値が返されます。 その他のエラーはすべて無視され、書式設定されていないネットワーク名が使用されます。

注釈

この関数を使用すると、ネットワーク ベンダーは、ユーザーに表示される前にネットワーク名をトリミングまたは変更できます。 たとえば、一般的な [開く ] ダイアログ ボックスの [ ドライブ ] コンボ ボックスには、接続されているすべてのリソースとそれに関連付けられているネットワーク名が表示されます。 各項目が表示される前に NPFormatNetworkName が呼び出され、ネットワーク プロバイダーには名前を編集してコンボ ボックスに収まるようにするオプションがあります。 さらに重要なのは、ネットワーク プロバイダーが名前を編集して、ネットワーク名の最も重要な部分をユーザーに表示できることです。

NPFormatNetworkName は、他のほとんどのネットワーク プロバイダー関数と同様に、各ネットワーク プロバイダーにルーティングされないことに注意してください。 各ネットワーク ベンダーは、独自のネットワーク名の書式設定についてのみ心配する必要があります。 ネットワーク プロバイダー ドライバーによって生成された名前のみが NPFormatNetworkName に渡されると想定できます。

WNFMT_ フラグは、通常、次の表に示すように、ユーザー インターフェイスのさまざまな場所で渡されます。 渡されるフラグの場所については、想定しないでください。この表は、各ネットワーク ベンダーがネットワーク名を変更するための最適な方法を決定するのに役立つためだけに用意されています。

Requirements