METADATA_GETALL_RECORD

The METADATA_GETALL_RECORD structure is analogous to the METADATA_RECORD structure, but is used only to return data from a call to the GetAllData method. Data retrieval specifications are provided in GetAllData method parameters, not in this structure (as is the case with METADATA_RECORD). The GetAllData method returns the data from multiple entries as an array of METADATA_GETALL_RECORD structures.

typedef struct  _METADATA_GETALL_RECORD {  
  DWORD dwMDIdentifier;  
  DWORD dwMDAttributes;  
  DWORD dwMDUserType;  
  DWORD dwMDDataType;  
  DWORD dwMDDataLen;  
  union  
    {  
    DWORD dwMDDataOffset;  
    unsigned char *pbMDData;  
    };  
  DWORD dwMDDataTag;  
}  METADATA_GETALL_RECORD;  

Members

• dwMDIdentifier
  A DWORD that identifies the metabase entry, for example, MD_SERVER_STATE.

• dwMDAttributes
  A set of flags that receives the attributes of the data entry. This member can receive one or more of the following values:

  Flag	Description
  METADATA_INHERIT	Return inherited data.
  METADATA_INSERT_PATH	Indicates the string contains MD_INSERT_PATH_STRINGW.
  METADATA_ISINHERITED	Returned data is inherited.
  METADATA_NO_ATTRIBUTES	No attributes set.
  METADATA_PARTIAL_PATH	Inherited data returned even if the entire path is not present. This flag is valid only if METADATA_INHERIT is also set.
  METADATA_REFERENCE	The data was retrieved by reference.
  METADATA_SECURE	Not valid.
  METADATA_VOLATILE	Not valid.

• dwMDUserType
  A DWORD that specifies the type of user of the data. IIS currently defines the following four user types:

  User type	Description
  ASP_MD_UT_APP	The entry contains information specific to ASP application configuration.
  IIS_MD_UT_FILE	The entry contains information about a file, such as access permissions or logon methods.
  IIS_MD_UT_SERVER	The entry contains information specific to the server, such as ports in use and IP addresses.
  IIS_MD_UT_WAM	The entry contains information specific to Web application management.

• dwMDDataType
  Specifies the type of data in the metabase entry. This member can be one of the following values:

  Data type	Description
  ALL_METADATA	All data returns, regardless of type. Not valid when setting values.
  BINARY_METADATA	Binary data in any form.
  DWORD_METADATA	An unsigned 32-bit number.
  EXPANDSZ_METADATA	A null-terminated Unicode string that contains unexpanded environment variables, such as %PATH%.
  MULTISZ_METADATA	An array of null-terminated strings, terminated by two null characters.
  STRING_METADATA	A null-terminated Unicode string.

• dwMDDataLen
  A DWORD that receives the length of the data in bytes. If the data is a string, this value includes the ending null character. For multisz data, this includes an additional null character after the final string. For example, the length of a multisz string containing two strings would be:

  (wcslen(stringA) + 1) * sizeof(WCHAR) + (wcslen(stringB) + 1) * sizeof(WCHAR) + 1 * sizeof(WCHAR)

• dwMDDataOffset
  If the data was returned by value, contains the byte offset of the data in the buffer specified by the parameter pbMDBuffer of the IMSAdminBase::GetAllData method. All out-of-process executions will return data by value. The array of records, excluding the data, is returned in the first part of the buffer. The data associated with the records is returned in the buffer after the array of records, and dwMDDataOffset is the offset to the beginning of the data associated with each record in the array.

• pbMDData
  Reserved. Do not use.

• dwMDDataTag
  Reserved. Do not use.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in Mddefw.h; include iiscnfg.h, iadmw.h.

See Also