aboutsummaryrefslogtreecommitdiff
path: root/src/libs/dutil/WixToolset.DUtil/inc/butil.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/libs/dutil/WixToolset.DUtil/inc/butil.h')
-rw-r--r--src/libs/dutil/WixToolset.DUtil/inc/butil.h60
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
6extern "C" {
7#endif
8
9enum BUNDLE_INSTALL_CONTEXT
10{
11 BUNDLE_INSTALL_CONTEXT_MACHINE,
12 BUNDLE_INSTALL_CONTEXT_USER,
13};
14
15
16/********************************************************************
17BundleGetBundleInfo - Queries the bundle installation metadata for a given property
18
19RETURNS:
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********************************************************************/
33HRESULT 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/********************************************************************
41BundleEnumRelatedBundle - Queries the bundle installation metadata for installs with the given upgrade code
42
43NOTE: 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.
45RETURNS:
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********************************************************************/
51HRESULT 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