METADATA_GETALL_RECORD

  • Article

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