Hade du nytta av den här sidan?
Din feedback om det här innehållet är viktig. Berätta vad du tycker.
Ytterligare feedback?
1500 tecken kvar
Exportera (0) Skriv ut
Visa allt
EN
Det här innehållet finns inte tillgängligt på ditt språk men här finns den engelska versionen,

AssocQueryStringByKey function

Searches for and retrieves a file association-related string from the registry starting from a specified key.

Syntax


HRESULT AssocQueryStringByKey(
  _In_      ASSOCF   flags,
  _In_      ASSOCSTR str,
  _In_      HKEY     hkAssoc,
  _In_opt_  LPCTSTR  pszExtra,
  _Out_opt_ LPTSTR   pszOut,
  _Inout_   DWORD    *pcchOut
);

Parameters

flags [in]

Type: ASSOCF

The flags that can be used to control the search. It can be any combination of ASSOCF values, except that only one ASSOCF_INIT value can be included.

str [in]

Type: ASSOCSTR

The ASSOCSTR value that specifies the type of string that is to be returned.

hkAssoc [in]

Type: HKEY

The HKEY value of the key that will be used as a root key. The search looks only below this key.

pszExtra [in, optional]

Type: LPCTSTR

A pointer to an optional null-terminated string with additional information about the location of the string. It is normally set to a Shell verb such as open. Set this parameter to NULL if it is not used.

pszOut [out, optional]

Type: LPTSTR

A pointer to a null-terminated string used to return the requested string. Set this parameter to NULL to retrieve the required buffer size.

pcchOut [in, out]

Type: DWORD*

A pointer to a value that, on entry, specifies the number of characters in the pszOut buffer. When the function returns, it points to the number of characters placed in the buffer.

If the ASSOCF_NOTRUNCATE flag is set in flags and the buffer specified in pszOut is too small, the function returns E_POINTER and the value is set to the required size of the buffer.

If pszOut is NULL, the function returns S_FALSE and pcchOut points to the required size of the buffer.

Return value

Type: HRESULT

Returns a standard COM error value, including the following:

ErrorMeaning
S_OKSuccess.
E_POINTERThe pszOut buffer is too small to hold the entire string.
S_FALSEpszOut is NULL. pcchOut contains the required buffer size.

 

Remarks

This function is a wrapper for the IQueryAssociations interface. It is intended to simplify the process of using this interface. For further discussion of how the file association functions work, see IQueryAssociations.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 5.0 or later)

Unicode and ANSI names

AssocQueryStringByKeyW (Unicode) and AssocQueryStringByKeyA (ANSI)

 

 

Gruppinnehåll

Lägg till
Visa:
© 2015 Microsoft