NPGetPropertyText function

Retrieves the names of buttons to add to a property dialog box for a network resource.


DWORD NPGetPropertyText(
  _In_    DWORD  iButton,
  _In_    DWORD  nPropSel,
  _In_    LPTSTR lpName,
  _Out_   LPTSTR lpButtonName,
  _Inout_ DWORD  nButtonNameLen,
  _In_    DWORD  nType


iButton [in]

Indicates the index of the button. File Manager supports a maximum of six buttons. This parameter is numbered 1-6 for each of the possible buttons if only one file is selected, or 11-16 if multiple files are selected.

nPropSel [in]

Specifies what items the property dialog box focuses on. This can be one of the following values.


A single file.


A single directory.


A selection of multiple files, directories, or both.


lpName [in]

Pointer to a null-terminated string that contains the names of the item or items to be viewed or edited by means of the dialog box. The only supported items are files and directories, so the item names are file names. These should be unambiguous, contain no wildcard characters, and be fully qualified (for example, C:\LOCAL\EXAMPLE.DOC). Multiple file names should be separated with spaces. A file name that contains spaces may be surrounded by quotes (for example, "C:\My File"). In this case. it is treated as a single name. The caret character '^' may also be used as the quotation mechanism for single characters (for example, C:\My^"File, "C:\My^"File" both refer to the file C:\My"File).

lpButtonName [out]

Pointer to a buffer where the network provider should copy the name of the property button. On success, the buffer pointed to by lpButtonName contains the name of the property button. If this buffer, on exit, contains the empty string, then the button corresponding to that name and all succeeding buttons will be removed from the dialog box. The network provider cannot "skip" a button.

nButtonNameLen [in, out]

Specifies the size of the lpButtonName buffer in characters, including the terminating null character.

nType [in]

Specifies the item type, which must be WNTYPE_FILE.

Return value

If the function succeeds, it should return WN_SUCCESS and lpButtonName can be used. If it points to the empty string, no button corresponds to an index as high as iButton. If the return value is other than WN_SUCCESS, the provider should also call SetLastError to set extended error information. Extended error codes include the following.

Return codeDescription

Could not load string from resources.


The given buffer is too small to fit the text of the button.


The lpName parameter is an unexpected form.


Property dialog boxes are not supported for the given object type, nType.



File Manager calls this function each time the property dialog box is brought up, and it does this before displaying the dialog box. If the user clicks a button added through this function by the network provider, the NPPropertyDialog function is called with the appropriate parameters.

Only File Manager calls NPGetPropertyText, and it uses this function for files and directories.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]