diff options
Diffstat (limited to 'src/libs/dutil/WixToolset.DUtil/inc/butil.h')
-rw-r--r-- | src/libs/dutil/WixToolset.DUtil/inc/butil.h | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/src/libs/dutil/WixToolset.DUtil/inc/butil.h b/src/libs/dutil/WixToolset.DUtil/inc/butil.h new file mode 100644 index 00000000..d1ec73bc --- /dev/null +++ b/src/libs/dutil/WixToolset.DUtil/inc/butil.h | |||
@@ -0,0 +1,60 @@ | |||
1 | #pragma once | ||
2 | // Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. | ||
3 | |||
4 | |||
5 | #ifdef __cplusplus | ||
6 | extern "C" { | ||
7 | #endif | ||
8 | |||
9 | enum BUNDLE_INSTALL_CONTEXT | ||
10 | { | ||
11 | BUNDLE_INSTALL_CONTEXT_MACHINE, | ||
12 | BUNDLE_INSTALL_CONTEXT_USER, | ||
13 | }; | ||
14 | |||
15 | |||
16 | /******************************************************************** | ||
17 | BundleGetBundleInfo - Queries the bundle installation metadata for a given property | ||
18 | |||
19 | RETURNS: | ||
20 | E_INVALIDARG | ||
21 | An invalid parameter was passed to the function. | ||
22 | HRESULT_FROM_WIN32(ERROR_UNKNOWN_PRODUCT) | ||
23 | The bundle is not installed | ||
24 | HRESULT_FROM_WIN32(ERROR_UNKNOWN_PROPERTY) | ||
25 | The property is unrecognized | ||
26 | HRESULT_FROM_WIN32(ERROR_MORE_DATA) | ||
27 | A buffer is too small to hold the requested data. | ||
28 | E_NOTIMPL: | ||
29 | Tried to read a bundle attribute for a type which has not been implemented | ||
30 | |||
31 | All other returns are unexpected returns from other dutil methods. | ||
32 | ********************************************************************/ | ||
33 | HRESULT DAPI BundleGetBundleInfo( | ||
34 | __in_z LPCWSTR szBundleId, // Bundle code | ||
35 | __in_z LPCWSTR szAttribute, // attribute name | ||
36 | __out_ecount_opt(*pcchValueBuf) LPWSTR lpValueBuf, // returned value, NULL if not desired | ||
37 | __inout_opt LPDWORD pcchValueBuf // in/out buffer character count | ||
38 | ); | ||
39 | |||
40 | /******************************************************************** | ||
41 | BundleEnumRelatedBundle - Queries the bundle installation metadata for installs with the given upgrade code | ||
42 | |||
43 | NOTE: lpBundleIdBuff is a buffer to receive the bundle GUID. This buffer must be 39 characters long. | ||
44 | The first 38 characters are for the GUID, and the last character is for the terminating null character. | ||
45 | RETURNS: | ||
46 | E_INVALIDARG | ||
47 | An invalid parameter was passed to the function. | ||
48 | |||
49 | All other returns are unexpected returns from other dutil methods. | ||
50 | ********************************************************************/ | ||
51 | HRESULT DAPI BundleEnumRelatedBundle( | ||
52 | __in_z LPCWSTR lpUpgradeCode, | ||
53 | __in BUNDLE_INSTALL_CONTEXT context, | ||
54 | __inout PDWORD pdwStartIndex, | ||
55 | __out_ecount(MAX_GUID_CHARS+1) LPWSTR lpBundleIdBuf | ||
56 | ); | ||
57 | |||
58 | #ifdef __cplusplus | ||
59 | } | ||
60 | #endif | ||