GetUrlCacheGroupAttributeA function (wininet.h)

Retrieves the attribute information of the specified cache group.

Syntax

BOOL GetUrlCacheGroupAttributeA(
  [in]      GROUPID                      gid,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwAttributes,
  [out]     LPINTERNET_CACHE_GROUP_INFOA lpGroupInfo,
  [in, out] LPDWORD                      lpcbGroupInfo,
  [in, out] LPVOID                       lpReserved
);

Parameters

[in] gid

Identifier of the cache group.

[in] dwFlags

This parameter is reserved and must be 0.

[in] dwAttributes

Attributes to be retrieved. This can be one of the following values.

Value Meaning
CACHEGROUP_ATTRIBUTE_BASIC
Retrieves the flags, type, and disk quota attributes of the cache group.
CACHEGROUP_ATTRIBUTE_FLAG
Sets or retrieves the flags associated with the cache group.
CACHEGROUP_ATTRIBUTE_GET_ALL
Retrieves all the attributes of the cache group.
CACHEGROUP_ATTRIBUTE_GROUPNAME
Sets or retrieves the group name of the cache group.
CACHEGROUP_ATTRIBUTE_QUOTA
Sets or retrieves the disk quota associated with the cache group.
CACHEGROUP_ATTRIBUTE_STORAGE
Sets or retrieves the group owner storage associated with the cache group.
CACHEGROUP_ATTRIBUTE_TYPE
Sets or retrieves the cache group type.

[out] lpGroupInfo

Pointer to an INTERNET_CACHE_GROUP_INFO structure that receives the requested information.

[in, out] lpcbGroupInfo

Pointer to a variable that contains the size of the lpGroupInfo buffer. When the function returns, the variable contains the number of bytes copied to the buffer, or the required size of the buffer, in bytes.

[in, out] lpReserved

This parameter is reserved and must be NULL.

Return value

Returns TRUE if successful, or FALSE otherwise. To get specific error information, call GetLastError.

Remarks

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).
 

Note

The wininet.h header defines GetUrlCacheGroupAttribute as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wininet.h
Library Wininet.lib
DLL Wininet.dll

See also

Caching

WinINet Functions