NPFormatNetworkName function (npapi.h)

Formats a network name in a provider-specific format for display in a control.

Syntax

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

Parameters

[in] lpRemoteName

Pointer to the network name to format.

[out] lpFormattedName

Pointer to a string that receives the formatted name.

[in, out] lpnLength

Pointer to DWORD that specifies the size, in characters, of the lpFormattedName buffer. If the return value of this function is WN_MORE_DATA, lpnLength contains the required buffer size, in characters.

[in] dwFlags

Bitfield that indicates the type of format being requested. This parameter can be one of the following values.

In addition, the following flag, which acts as a modifier to the preceding flags, can be included by using a bitwise-OR operation.

[in] dwAveCharPerLine

Specifies the average number of characters that will fit on a single line where the network name is being presented. Specifically, this value is defined as the width of the control divided by the tmAveCharWidth field of the TEXTMETRIC structure from the font used for display in the control.

Return value

If the function succeeds, it should return WN_SUCCESS.

If the function fails, it should return the following value. All other errors will be ignored, and the unformatted network name will be used.

Remarks

This function allows network vendors to trim or modify network names before they are presented to the user. For example, in the common Open dialog box, the Drives combo box presents all connected resources and their associated network name. Before each item is displayed, NPFormatNetworkName is called, and the network provider has the option of editing the name so it will fit in the combo box. More important, the network provider can edit the name to present the most significant portion of the network name to the user.

Note that NPFormatNetworkName is not routed to each network provider like most of the other network provider functions are. Each network vendor need worry only about formatting their own network name. They can assume that only names produced by their network provider driver will be passed to NPFormatNetworkName.

The WNFMT_ flags are typically passed at various places in the user interface as described in the following table. No assumptions should be made about what flags are passed where; this table is provided solely to help each network vendor decide the best method for modifying their network name.

Requirements